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PREFACE 



This instant outlines the SIMSCRIPT II.5 program- 
ming language for the CONTROL DATA computer 
systems. More detailed information on the 
SIMSCRIPT II. 5 language can be obtained from 
the following manuals: 

P.J. Kiviat, R. Villanueva, H.M. Markowitz 
SIMSCRIPT II.5 Programming Language 
(CACI) 

SIMSCRIPT n.5 Reference Handbook 
(CACI) 

SIMSCRIPT n.5 User's Manual-CONTROL 

DATA computer systems (CDC) 

(CACI) 
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SIMSCRIPT 11.5 ELEMENTS 

NAMES Examples 

Combination of letters, digits and periods arranged 
as follows; X 

— contains at least one letter or WAITING.LINE 

— contains digits and at least two non-terminal 

periods. IB 

— cannot be broken across card boundaries. 1 .2.3 

1.5E15 



CONSTANTS 




Examples 


Integer 


Combination of up to 18 digits 


2 

347 

314159265 


Real 


Combination of up to 15 digits 
containing at least one period 


3.14 
1. 
.759 


String 


Sequence of characters enclosed 
within ". 


"ABCD" 


Text 


Sequence of characters enclosed 
within 1 . 


1 TEXT IS: 1 


VARIABLES 






Integer 


Range - (259 _i) to 259 -1 . As a 





result of multiplication or division 
or conversion from real to integer, 
or integer to real, maximum value 
is 248-1. 

Integer packed . Bit packed (n-m) 
l<n<m<60 
. Field packed (n/m) 
m = 2,3, 4,5, 6,10,12, 15 
n = 1 to m 
. Intra-packed (*/m) 
m = 2,3,4,5,6,10, 12, 15 
Real Range 10-293 to 10+322 

(approximately 1 5 significant digits) 

Alpha Up to 10 characters for a replacement 

statement. 
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SOURCE LAiMGUAGE 
NOTATION 

The notation employed in describing SIMSCRJPT II.5 is a combina- 
tion of conventions used in several computer programming language 
descriptions! In the following pages: 

1 . Words in capital letters are statement keywords. 

2. Primitives shown in italics are basic language constructs. They are: 

name 
integer / 
number n 
string s 
text r 

3. A metavariable denotes an occurrence of an element of the type 
represented by the metavariable symbol shown in italics. 

4. A statement is a combination of keywords, primitives, and meta- 
variables that follows a certain pattern, called the syntax of the 
statement. 

5. Brackets [ ] and braces ] [ denote choices. When brackets appear, 
a choice may be made from the options indicated. When braces 
appear, a choice must be made. The items available for selection 
appear in a vertical list within the brackets or braces. When a 
choice can be repeated, a symbol (or symbols) that must separate 
the items in the list of choices is written at the upper right-hand 
corner of the brackets or braces. For example, if a choice appears 
as I g [ the sequence A^,B,A, . . ., B might be selected. The choice 
represented by | A | ' is logically equivalent to A [,a] [,a] . . . [,a] . 

6. The nuU character 5S is used to indicate that no symbol need 
separate the items in a Hst of choices. An example of |g \ might 
be aababb ... a. The choice represented by | a j ** is logically 
equivalent to A [A ] [A ] . . . [a ] . 

7. A hst separator symbol can itself be complex, involving choices 

(AND) 
and repetitions, as in |b) ^^ instance of which might be 

A AND B OR A OR B. 

8. Plural /ce/words ending in s such as variables and lines, can 
be written in singular form as VARIABLE or LINE when called for 
by the grammar of a statement. 
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SYMBOLS 



character 



letter 

special character 

digit 

blank 

period 



letter = 



special character = 



digit = 



blank = period = 



\.7 \;/ 



empty 
space 
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METAVARIABLES 



arithmetic expression e = 



ie) 



I 



comma c = ^ 


,AND 




( 


AND 


lO, phK, 


cfur = 




/ 


IBACKFROMI 
IIUIIIC ^ ^ ^ 




(EACH . 
■ EVERY . 


(name I 


FOR \ 


) 



< AU ' I „„„■ [1"°'" ',.].''" 

"'-'- I '""'" I AFTER I ' ION 

'- -I AT 

EACH name IW THE DICTIONARY 



[][;:■ 



• UN REVERSE ORDERl 



Be) 
format /, = <' S e > 

V 1 



/l 

;' Ce 

i I e 

format fo = ■{ i A e 

i D ( e,e ) 
/ E ( e,e ) 
/Te 



label/ =■ 
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logical 
expression = 



\ \ 



e {(ISine) ^ 

(positive ) 

ellSllNOTl ^negative)" 

(zero ) 
(real ] 

MODE [ISl[NOTl< INTEGER > 

(alpha ) 
data [1s1[n0t1 ended 
card [isjinoti new 

PAGE [ISl [NDTl FIRST 
LTHfsJ I'llSIlNOTl EMPTY 



pHE^JelSINOTlIN 



/INTERNAL \ 

EVENT IS INOTl < EXTERNAL I 
tvtiMi It, iNuij •) ENDOGENOUS ( 

'-EXOGENOUS ; 



/true U 

\FALSEJJ 



relational 
operator Q, = 



EQUAL TO 

equals 



NOT EQUAL TO 



GREATER THAN 



NOT GREATER THAN 
NO GREATER THAN 



selection clause sc 



(with 

= < [except] when 
(unless 



[,1 
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. . ,. , , /whileI 

termination clause tc =S Hwyii 




t 
name 



word w 



special dwracter 



Words must be separated from each other by 

one or more blanks unless they are special 

characters. 

Periods ( . ) are ignored between words and at 

the end of statements. 

Comments can be inserted between any two 

words in a program by enclosing them in 

quote marks (") formed by two consecutive 

apostrophes. The riglit-hand set of quotes is 

not necessary if the comment is the last item 

on a card. 
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LANGUAGE STATEMENTS 



v\_\ rTHEirnamel 



! ACCUMULATE I 
TALLY \ 



Average 

AVG 

MEAN 

SUM 

NUMBER 

NUM 
[VARIANCE 

VAR 

STD.DEV 
|STD 

SUM.OF.SQUARESI 
fSSQ 

MEAN.SQUARE 

MSQ 

MINIMUM 

MIN 

MAXIMUM 
, MAX 



name (n TO n BY n) < _ M THE name HISTOGRAM/ 
Specifies automatic data collection and analysis for named variables. 





— 1 






/SCHEDULE ) 


[A 1 






\ ACTIVATE / 


LanJ 


name CALLED 


V 


< CAUSE > 




/ REACTIVATE \ 


TTHE [ABOVE]] 

[this J 


Ueschedule/ 








- 


/ ATe 


Cdays 




(given 1 , .c 

iGlVINGj ^^1 


yjAFTER/ 


) UNITS 
1 HOURS 




(Ml 


j fNOW ) 

f In EXT/ 


(minutes 


Files an event notice 


in the events set accc 


rding to its time. 




ADD e TO V 








Adds the value of p 


p> the value of the va 


riable v. 





(advance ) (input [(files 
jbackspace \ ^ i output \ \ records 



USING 



TAPE 
UNIT 
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BEFORE 
AFTER 



CREATING r 


A 
AN 


DESTROYING ( 


THE 


J 


_anyJ 


FILING i 


IN 


REMOVING j 


FROM 


CAUSING r 


"a 

AN 


CANCELING ( 


THE 


) 


_ANY_ 



, ] CALL name 



Specifies a call to a named routine whenever the indicated statement is 
executed. Inputs to the routines are; 





BEFORE 


AFTER 


CREATE 


Not aUowed 


Entity identifier 




DESTROY 


Entity identifier 


Not allowed 




CAUSE 


Entity identifier, time 


Entity identifier. 


time 


CANCEL 


Entity identifier 


Entity identifier 




FILE 


Entity identifier, subscripts 


Entity identifier, 


subscripts 


REMOVE 


Entity identifier, subscripts 


Entity identifier. 


subscripts 



[ALSO] 



^fory 


'for- 
te 


DO 


\tc j 


__sc _ 





THIS 
THEFOLLOWING_ 

Logical phrases control the execution of statements that follow them. When 
more than one statement is to be controlled, the word DO precedes them. 
Multiple control phrases terminating control on the same LOOP statement are 
preceded by the word ALSO. 

(ALWAYS 1, 

Iregardless) 

Synonyms indicating the transfer point of the false condition of a preceding 
IF statement. 

BACKSPACE - See ADVANCE 



BEFORE — See AFTER 

BEGIN HEADING 

Marks the beginning of a heading block within a report section. 
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BEGIN REPORT [ON A NEW PAGE] [PRINTING for IN GROUPS OF 

[PER PAGE]] 

IVIarks the beginning of a report section. 



CHIGHI cTHEN 

BREAK name TIES < BY ^ ^^^ \ name > 

Establishes a priority order within an event class. 



Tperform^ 

<CALL > name 

(now ) 



(-THE 

)THIS k , y 

) GIVEN 1 \^l 

UlVING- 



(l^)') 



YIELDING {v}' 



Calls a routine used as a procedure. Both input GIVEN and output 
YIELDING argument lists are optional. 



CANCEL 



name 



CALLED V 



THE [ABOVE]" 
THIS 
Removes a scheduled event notice from the event set. 



CAUSE - See ACTIVATE 



\ CLOSE (ItAPElg 
lENDFILEiLUNITj ' 

Writes an end-of-file mark on an output device. 
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«>H 



.11 



AVERAGE 

AVG 

MEAN 

SUM 

NUMBER 

NUM 

VARIANCE 

VAR 

STD.DEV 

STD 

SUM.OF.SQUARES 

SSQ 

MEAN.SQUARE 

MSQ 

MINIMUM (e) 

MIN(el 

MAXIMUM (e) 

MAX(e) 

MINIMUM 

MIN 

MAXIMUM 

MAX 



Must be controlled by a logical control phrase. Computes the indicated 
statistics of the expression e after the LOOP statement if the 
control is over a DO. . .LOOP block. 



DESTROY 
CREATE 



r^ ] name [CALLED )■] 

EACH ] i I 

ALL > {name [(e)] ) 

every) i ) 



\ CYCLE! 
I NEXT \ 
A control statement. 
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DEFINE|/wme [ AS [A] 



fFIFO 
AS [A] 

Llifo_ 


SETS 


( (HIGH) )cTHEN 
RANKED<^By| jname\ 






/ FF 


\" 1 


g 1> ATTRIBUTES 
N \ 




\ FB 


1 




FA 




[,] 


without( rf 


) ROUTINES 




RL 




M/ 




/ RS 
1 ^ 


1 








\ F 


/ 



WITHOUT 



Defines set ranking, owner and member attributes and generated set 
processing routines. 



/INTEGER^j 
) ALPHA I 
) REAL ( 
VTEXT ) 

RELEASABLE 
FORTRAN 



DEFINE <name)> AS 



ROUTINES ( 
FUNCTIONsi 



-JGIVING| r^ALUES " 
< GIVEN }i\ 

(with ) Larguments. 



YIELDING!" 



VALUES 



ARGUMENTS 



DEFINE I wa/we} AS 



INTEGER 
STREAM; 
REAL 



VARIABLES] 
ARRAYS J 



DEFINE <mme> AS 



LanJ 



SIGNED INTEGER) 

INTEGER 

ALPHA 

REAL 

TEXT 

'DIMENSIONAL^ 

.DIM j 

DUMMY 

SUBPROGRAM 

FORTRAN 

EXTENDED 
f SAVED 1 

\ recursive/ -J 



MONITORED ON sTtHeI | 
Define properties of global and local variables, and routines, 
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VARIABLES I 
ARRAYS i 



(LEFT 
RIGHT, 



DEFINE w TO MEAN {wj ^ 

Instructs the compUer to substitute the words (up to the end of the card on 
which the statement appears) following the keyword MEAN for the indicated 
word in all subs equent statements, before they are cotnpiled . 

DESTROY - See CREATE 



DO - See ALSO 



(ELSE I 

\otherwise) 

Synonyms indicating the transfer point of the false condition of a 
preceding IF statement. 



END 

Maries the end of a program preamble, routine, report section, and heading 

block of a report section. 

ENTER WITH v 

Used to transfer a "right-hand" value to a left-handed function. 



rUPON ) 

event) 




n«ame) ) 



SAVING THE EVENT NOTICE 



Event declaration. Unless SAVED, an event notice is destroyed before an 
event routine is executed. 



EVENT NOTICES [iNCLUDE {name) J 



EVERY I name } 
THE SYSTEM 



MAY 
CAN 




RANDOn 



STEP 
LINEAR 



(VARIABLES 
I ARRAYS 



IN ARRAY i 
IN WORD f 
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EVERY j name 
THE SYSTEM 




(HAS ) \ ( A 

] HAVE ( / 3 AN 

jOWNS f ) jTHE 

(belongs to) / 'some! 



IN ARRAY/ 
IN WORD 2 
FUNCTION 
DUMMY 



Entity-attribute-set structure declaration. Specifies attribute packing, equivalence, 
word assignment and function options. 

(entities) , , c 

extended \ \ INCLUDE {name) 

(ARRAYS \ ^ 

Defines extended memory data structures. 



(external 
(exogenous 



W EVENT lu.iTSAREi!^'"^ 

ji process/ \i i 



Names units from which external event data will be read. 
^EXTERNAL WEVENTS KrE U^4 ' 

Iexogenous/ (processes/ * ' 

Declares the names of events that can be triggered externally. 





"first 






FILE 


THE 
JHIS_ 


e 


LAST 

/before! 

1 AFTER ) 


> e 


IN 


THE 
THIS 


V 


Files an entity in a set. 





FIND 



THE FIRST CASE 

V = [THE] [FIRST] e) 



[J 



(■POUNDI 
(NONE / 



Must be controlled by a logical control phrase, but cannot be within a 
DO...LC)OP block. The optional IF phrase directs control after the control 
phrase has been completed, depending upon the "success" of the FIND. 

FOR — See ALSO and for metavariable 
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M-"'^' K FUNCTION >L:nB ' 



' (subroutine 



Uiving( ]««'«4' 

VGIVEN ) V ; 



Uname) \ 

rviELDING {name) J 



Subprogram declaration. Routines used as functions only have GIVEN 
arguments. If LEFT or RIGHT are not stated, RIGHT is implied. 

Controls the generation of LIST ATTRIBUTES routines for entities. By 
default, no LIST routines are generated. 



V[(e)]' 



Transfers control to the indicated label. 



GO [T0]<^,,> '• ' PERe 

Transfers control to the n* label in the label list according to the integer 
value of the transfer expression e. 



HERE — A control statement 



IF 0[,] — See metavariable 



INTERRUPT name [CALLED v] 



(ahead) 

JUMP < > 

[back ) 

A control statement. 

V[(i)]' 

A statement label identifies a transfer point. 
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LAST COLUMN <!i>/ 

Characters beyond column / are ignored on subsequent cards. 

LEAVE — A control statement. 

LET V = e 

Assigns the value of e to the variable v. 

If V is integer and e is real, the result is rounded before storing. 



LIST < {name [CALLED e] 

ATTRIBUTES OF I 

I^EACHMawe [OFv] 

A free-form output statement that labels and displays values of expressions 
and 1- and 2-dimensional arrays. 

("LOOP ) 
I REPEAT/ 

Used with DO to delimit a group of statements controlled by one or more 
togical control phrases. 

MAIN 

Marks the beginning of a program's main routine. Execution commences at 
the first executable statement after MAIN. 

MOVE 1"°" ' 
(TO V 

Used within a routine defined for a monitored variable to access or set the 
value of the variable. 



NEXT — See CYCLE 



OTHERWISE — See ELSE 
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,r , \ TVDc/lsl /saved \ 
NORMALLY [J ] TYPE |_| \rECURSIVE/ 

/dimension) (is 

(DIM j \= 

Establishes background conditions for properties of variables and functions 
that are effective unless overridden by subsequent DEFINE declarations or, 
in the case of local arrays, first use. , 

NOW — See CALL 



PERFORM — See CALL 



VERY OLD 
OLD 

.NEW 



PREAMBLE 



Maries the beginning of the program preamble. 



PRINT; [DOUBLE] LINES 



WITH 



A GROUP OF |e ['^FIELDS 
SUPPRESSING FROM COLUMN ; 



LIKE THIS ) 
THUS } 

AS FOLLOWS) 

The / lines following the PRINT statement are format lines containing text 
and pictorial formats for the display of indicated expression values. The phrases 

A GROUP OF ]e [^FIELDS and SUPPRESSING FROM COLUMN / 
can only be used within report sections that have column repetition. 

PRIORITY ORDER IS {name) ^ 

Assigns a priority order to different classes of events. 
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PROCESS name 



THE j 

THIS ( 

GIVEN ( {mmey 

GIVING ; 



{{name) ) 



PROCESSES [include {mzme}'^] 



REACTIVATE - See ACTIVATE 



READ 



BINARY 



AS 



[(0]</2 



USING 



Used without an AS clause indicates a free-form data input. 



THE BUFFER 

fTAPEl 
LUNITJ'' 



RECORD 



MEMORY 
STATUS 



REGARDLESS — See ALWAYS 



RELEASE {v} 

Releases blocks of core pointed to by v; v's are assumed to be pointer variable 



RELINQUISH e [UNITS OF] name [(e)] 



REMOVE 



THE 



{lTs?}^ ) 

[THIS 1 ( "^ROM 

LaboveJ ^ ; 



THE 
THIS 



Removes an entity from a set. 
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REPEAT - See LOOP 



REQUEST e [UNITS OF] rnmelU)] [, WITH PRIORITY d 



RESCHEDULE - See ACTIVATE 



( c BY 

RESERVE |(v} AS {e) [BY 

Allocates blocks of core of specified size to the pointer variables v. Words 
assigned are dat a if no BY* phrase appears, and are pointe rs otherwise. 

RESET [THE][na?nel TOTALS OF | v} 

Initializes ACCUMULATE or TALLY counters associated with v. If 
TOTALS is not qualified by a word, all counters of v are initialized. 



RESOURCES [include [name] J 



RESUME name [CALLED v] 



{s™eIs} substitution 

Used to override a currently defined substitution. This statement must not 
be placed on program cards with other statements. 



RETURN 



IwiTHi 



Used as a procedure, a routine returns control to its calling program with the 
statement RETURN; used as a function, a routine returns con&ol and a value 
to its calling program by either of the statements RETURN (e) or RETURN 
WITHe 
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REWIND 



TAPE 
UNIT 



Rewinds an mput/output device. 



ROUTINE — See FUNCTION 



SCHEDULE — See ACTIVATE 



SKlPe. 



FIELDS 
INPUT 



(cards ] 




Applies to the current input or current output unit. SKIP e FIELDS applies 
to the cmrent input unit only when it is used for freeform data input. 
CARDS, LINES, and RECORDS are synonyms. If neither UNPUT nor 
OUTPUT is specified, INPUT is implied. 



START NEW 



Applies to the current input or current output unit. LINE, CARD, and 
RECORD are synonyms. If neither INPUT nor OUTPUT is specified, 
INPUT is implied. 

START SIMULATION 

Starts simulation by removing the first event from the events set and 
executing it. 

STOP 

Halts program execution. 

STORE e IN V 

Assigns a value to a variable without mode conversion. 
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SUBROUTINE — See FUNCTION 



SUBSTITUTE {tUe|e}/ LINES FOR w 

Similar to DEFINE TO MEAN but allows more than one card of 
words to be substituted. 

SUBTRACT e FROM v 

Subtracts the value of e from the value of the variable v. 



SUPPRESS — See RESUME 

SUSPEND [process] 

The suspend statement may only appear in a process routine. The process is 
placed in the passive state. 

[the] system 

See EVERY 

TALLY — See ACCUMULATE 

( TEMPORARY entities) ^-, 

} V INCLUDE|«awe I J 

I PERMANENT ENTITIES^'" 

Declares the type of following EVERY statements to be permanent or 
temporary, as the case may be. 

THE SYSTEM — See EVERY 

[THEN] IF [,] 
SeelF 



TRACE 



USING 



TAPE 
UNIT 



Produces a backtrack of current subprogram calls. When the SIMSCRIPT II 
operating system uses TRACE the standard output device (printer) is used. 
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UNLESS — See tc raetaraviable (termination clause) 



UNTIL — See sc metavariable (selection clause) 



UPON — See EVENT 



THE BUFFER ( j^p^^ ) 

USE j r-TAPEl } FOR 



OUTPUT 



Sets the indicated input/output device as the current input or output unit. All 
subsequent input/output statements that do not specify their own devices in 
USING phrases use these current units. THE BUFFER causes reading and 
writing in an internal file. 

C UNIT ) 
WORK 1 \ DAYS f 
WAIT I ^ J HOURS r 

( MINUTES ) 



WHEN — See sc metavariable (selection clause) 



WHILE — See tc metavariable (termination clause) 



WITH — See sc metavariable (selection clause) 



WORK — See WAIT 



WRITE, 



I AS 



AS 



BINARY 



[(e)] 




USING 



'THE BUFFER' 

I [unit] ^ 
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Attributes and Routines Required for Set Statements 



ATTRIBUTES ROUTINES 




REQUIRED REQUIRED 


SET 1 — 1 — 1 — I— 
STATEMENT F L P S 


5 M N FF Fl 


. FB FA RF RL RS 


FILE FIFO F L 


3 F 


- 




FILELIFO F 


3 FF 






FILE ranked F P 


S FF 






FILE FIRST F 


S FF 






FILE LAST F L 


S F 


L 




FILE BEFORE F P 


S 


FB 




FILE AFTER F 


S 


FA 




REMOVE FIFO F 


S 


RF 




REMOVE UFO F 


S 


RF 




REMOVE ranked F 


S 


RF 




REMOVE FIRST F 


S 


RF 




REMOVE LAST F L P 


S 




RL 


REMOVE specific F P 


S 




RS 


set IS EMPTY F 








IS IN set 


M 






FOR EACH... OF set F 


S 






FOR EACH... OF set ^ p 








...REVERSE 








FOR EACH... FROM 


S 






...OF set 








FOR EACH... FROM p 








...OF set... REVERSE 








FOR EACH... AFTER 


s 






. . .OF set 








FOR EACH... AFTER p 








...OF set... REVERSE 








Automatic checking 


M 
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Statistical Keywords for ACCUMULATE Statement 


STATISTICAL 






REQUIRED 


KEYWORD 


SYNONYM 


COMPUTATION 


COUNTERS 


NUMBER 


NUM 


N 


N 


SUM 




2X*(TIME.V-Tl) 


SUM,Tl 


MEAN 


AVG 
AVERAGE 


SUM/(TIME.V-Tg) 


SUM.Tl.Tq 


SUM.OF.SQUARES 


SSQ 


sx2*itime.v-Tl) 


SSQ.Tl 


MEAN.SQUARE 


MSQ 


SSQ/(TIME.V-Tg) 


SSQ,Tl,To 


VARIANCE 


VAR 


MSQ-MEAN^ 


SSQ.SUM.Tl.Tq 


STD.DEV 


STD 


SQRT.F(VAR) 


SSQ.SUM.Tl.Tq 


MAXIMUM 


MAX 


M = maximum (X) for 
ailX 


M, N 


MINIMUM 


MIN 


m = minimum (X) for 
allX 


m, N 


NOTES: 








TIME.V 


current simulated time 




Tl 


simulated time at which variable was set to its 




current value 






To 


simulated time at which accumulation 


started 


X 


sample value 


of accumulation variable (before it 




changes to a new value) 
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Statistical Keywords for TALLY Statement 


STATISTICAL 






REQUIRED 


KEYWORD 


SYNONYM 


COMPUTATION 


COUNTERS 


NUMBER 


NUM 


N 


N 


SUM 




2X 


SUM 


MEAN 


AVG 
AVERAGE 


SUM/N 


SUM, N 


SUM.OF.SQUARES 


SSQ 


2X2 


SSQ 


MEAN.SQUARE 


MSQ 


SSO/N 


SSQ,N 


VARIANCE 


VAR 


MSQ-MEAn2 - 


SSQ, SUM, N 


STD.DEV 


STD 


SQRT.F(VAR) 


SSQ, SUM, N 


MAXIMUM 


MAX 


M = maximum (X) 
for all X 


M, N 


MINIMUM 


MIN 


m = minimum (X) 
for all X 


m, N 


NOTE: Xisthesan- 


pie value of tallied variable (before It changes to a 


new value). 
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Statement 
Type 


Statement 


Rules 


la 
lb 
Ic 
Id 
le 
If 


NORMALLY 
DEFINE TO MEAN 
SUBSTITUTE 
SUPPRESS SUBST. 
RESUME SUBST. 
GENERATE 
INHIBIT 


Can appear anywhere in preamble. 


2a 
2b 
2c 


TEMPORARY ENTITIES 
PERMANENT ENTITIES 
EVENT NOTICES 


A preamble may contain many 
Type 2a, 2b, and 2c statements. 
Each may be followed by a group 
of Type 3a, 4, and 5 statements. 


3a 
3b 


EVERY 
THE SYSTEM 


Many can follow a Type 2 state- 
ment. An entity or event notice 
name can appear in more than 
one EVERY statement. 


4 


DEFINE VARIABLE 


No precedence relation if it defines 
a global variable. 

Must follow all Type 3a statements 
if it defines an attribute named in 
them. 

A variable, attribute, or function 
name can appear in only one 
DEFINE statement. 


5 


DEFINE SET 


Must JFollow Type 4 statements in 
a Type 2 statement group if it 
qualifies a set named in them. 


6a 
6b 
6c 


BREAK TIES 
EXTERNAL EVENTS 
EXTERNAL UNITS 


One statement allowed for each 
event notice. 


7 


PRIORITY 


Must follow all Type 2c and 6b 
statements. 


8a 
8b 


BEFORE 
AFTER 


Allowed for each temporary 
entity, set, and event notice. 


9a 
9b 


TALLY 
ACCUMULATE 


Either TALLY or ACCUMULATE 
statistics but not both, may be 
specified for unsubscripted global 
variables, attributes of permanent 
or temporary entities, event 
notices, processes or resources. 



Of these statements, only Types 1 and 4 can be used in routines to 
declare local background conditions, variables, and substitutions. 
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SYSTEM DEFINED NAMES 



Variable 



SYSTEM DEFINED VALUES 
Mode Description 



Default 



BETWEEN.V Subprogram 

BUFFER.V Integer 
EOF.V Integer 



EVENT.V Integer 

EVENTS.V Integer 

F.EV.S(*) Integer 

HEADING.V Integer 



HOURS.V 


Real 


LINE.V 


Integer 


LINES.V 


Integer 


L.EV.S (*) 


Integer 



MARK.V 



Alpha 



MINUTES.V Real 



Subprogram variable called 

before each event is 
executed. 

The length of the internal 1 3 2 

buffer. 

End-of-file code; zero denotes 
notes that an end-of-file 
marker is an error; one 
indicates return control with 
EOF.V set to 2 when end- 
of-file is encountered; one 
for each input unit.'' 
Code representing the 

event class to occur next. 
The number of event classes. 

Array containing the first- 

in-set pointers for the event 
set, EV.S 

A subprogram variable tested 

by the system for each new 
page.tt 

Number of hours per simu- 24 

lated day. 

Number of the current 1 

output line.'' 

Number of lines per page.*' 55 

Array containing the last-in-set 

pointers for the event set EV.S 

Termination character * 

required on external event 
cards and on the input for 
random variables. 

Number of minutes per 60 

simulated hour. 



tt A separate value is maintained for each unit; only the currently used 
value is accessible to the program. 
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Variable 


Mode 


Descriptfon Default 


N.EV.S (n) 


Integer 


Function returning the number of 
pending event notices of class n. 




PAGE.V 


Integer 


Number of the current 
page.tt 


1 


PAGECOL.V 


Integer 


If # 0, column number in 
which the word PAGE and 
the value of PAGE.V is to 
be printed on the output 
listing.'* 





PARM.V M 


Alpha 


Array countaining the user 
parameters passed to the program. 




PRMB.V(*) 


Integer 


Array countaining the values of 
the attributes of THE SYSTEM 
with IN WORD clauses. 




RCOLUMN.V 


Integer 


Pointer to the last column 
read in the input buffer.tt 





READ.V 


Integer 


Number of the current 
input unit. 


5 


RECORD.V(n) 


Integer 


The number of records read 
from or written on the 
indicated unit. 





RRECOIID.V 


Integer 


The number of records read 
from the current input unit.tt 





SEED.V 


Integer 


Array containing initial ran- 
dom numbers. 


Yes 


TIME.V 


Real 


Current simulated tune. 





WCOLUMN.V 


Integer 


Pointer to the column last 
written in the output buffer.tt 





WRECORD.V 


Integer 


The number of records 
written on the current out- 
put unit.tt 





WRITE.V 


Integer 


Number of the current output 
unit. 


6 


tt A separate value is maintained for each unit; only the currently used 
value is accessible to the program. 
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SYSTEM DEFINED CONSTANTS 


Constant 


Mode 


Description 


EXP.C 


Real 


2.7182818284590452 


INF.C 


Integer 


Largest INTEGER value that can 
be stored. 


PLC 


Real 


3.1415926535897932 


RADIAN.C 


Real 


57.295779513082321 degrees/ 
radian 


RINF.C 


Real 


Largest REAL value that can be 
stored. 
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SYSTEM DEFINED FUNCTIONS 



Function 
Mnemonic 



Arguments' 



Function 
Mode 



Description 



ABS.F e 

ALPHA.F a,b 

AND.F a,b 

ARCCOS.F e 

ARCTAN.F 61,62 

BETA.F 61,62,63 



Mode of 6 Returns the absolute 
value of the expres- 
sion. 



Integer Compares two 

alphanumeric words a 
and b and returns: 
—1 ifa<b 
Oifa = b 
lifa>b 

Integer Logical product of a 
andb. 

Real Computes the arc 

cosine of a real ex- 
pression; -1> e > 1 

Real Computes the arc tan- 

gent of 61/02; (61,62) 
#(0.0) 

Real Returns a random 

sample from a beta 
distribution 

61 = power of X, real; 
ei>0 

62 = power of (1-x), 
real; 62 >0 

63 = random number 
stream, integer 

Integer Returns a random 
sample from a bi- 
nomial distribution 

61 = number of trials, 

integer 

62 = probability of 

success, real 

63 = random number 

stream, integer 
COS.F e Real Computes the cosine 

of a real expression 
given in radians, 
te = expression that can be of any complexity, including functions 
V = variable 



BINOMIAL.F 61,62,63 
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1 


DATE.F 61,62,63 Real 


Converts a calendar 
date to cumulative 
simulation time, 
based on values 
given to ORIGIN.R 


' 1 






61 = month, integer 








62 = day, integer 


1 






63 = year, integer 




DAY.F e 


Integer 


Converts simulation 
time to the day por- 
tion based on values 
given to ORIGIN.R 

e = cumulative 

simulation time, 
real 


' 


DIM.F v(*) 


Integer 


Returns the number 
of elements pointed 
to by the pointer 
variable v, in the 
dimension of the 
array v. 




DIV.F 61,62 


Integer 


Returns the trun- 
cated value of (ei/ej) 

61= dividend, 
integer 

62 = divisor, integer; 

62^0 




EFIELD.F none Integer 


Returns the ending 
column of the next 
data field to be read 
by a READ Free 
Form statement. 


! 


ERLANG.F ei, 


52.63 Real 


Returns a sample 
value from an Erlang 
distribution 

61 = mean, real 

62 = k, integer 

63 = random num- 

ber stream, integer 


1 
1 


30 
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Function 
Mnemonic 


Arguments 


Function 
Mode 


Description 


EXP.F 


e 


Real 


Computes EXP.C 
to the etli power; 
e must be real. 


EXPONEN- 
TIAL.F 


61,62 


Real 


Returns a random 
sample from an ex- 
ponential distribu- 
tion 

61 = mean, real 

62 = random number 

stream, integer 


FRAC.F 


e 


Real 


Returns the fractional 
portion of a real ex- 
pression. 


GAMMA.F 


61,62,63 


Real 


Returns a random 
sample from a gamma 
distribution 

ei = mean, real 

62= k, real 

63 = random number 
stream, integer 


GAMMAJ.F 


61,62,63 


Real 


Same as GAMMA.F 


HOUR.F 


e 


Integer 


Converts event time 
to the hour portion 

6 = cumulative 
event time, 
real 


INT.F 


v,e 


Integer 


Returns the rounded 
integer portion of a 
real expression. 


ISTEP.F 


V, e 


Integer 


Returns a random 
sample from a look-up 
table without inter- 
polation 

V = variable that 
points to the 
look-up table 

e = random number 
stream, integer 
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Arguments 



Function 
Mode 



ITOA.F 



LIN.F 



V, e 



Alpha 



Real 



LOG.E.F e 



Real 



LOG. ei,e2,e3 Real 

NORMAL.F 



LOG.IO.F e 



MASK.F 



Real 



Integer 



Description 



Converts an integer 
expression to an 
alpha-numeric value, 
left adjusted in a 
blank field. 
Returns a random 
sample from a 
look-up table, 
using linear inter- 
polation 

V = variable that 
points to the 
look-up 
table 

e = random num- 
ber stream 
integer 

Computes the 
natural logarithm 
of a real expression 
e>0. 

Returns a random 
sample from a 
lognormal distri- 
bution 

ei = mean, real 

e2 = standard devia- 
tion, 

63 = random num- 
ber stream, 
integer 

Computes logio of 
a real expression; 
e >0. 

Builds a left 
justified mask 
of e bits. 
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Function 
Mnemonic 


Arguments 


Function 
Mode 


Description 


MAX.F 


ei,e2,..., e„ 


Real if any 


Returns the value of 






e/ real; if 


the largest e,-. 






none, 








integer 




MIN.F 


61,62,.. ., e„ 


Real if any 


Returns the value of 






a,- real; if 


the smallest e,-. 






none, 








integer 




MINUTE.F 


e 


Integer 


Converts event time 
to .the minute 
portion 

e = cumulative 
event time, 
real 


MOD.F 


61,62 


Real if 


Computes a remain- 






either e,- 


der as 






real; if 
none, 


ei-TRUNC.F(ei/e2) 
*e2; 

62 #0 






integer 


MONTH.F 


e 


Integer 


Converts simulation 
time to month portion 
based on values given 
to ORIGIN.R 

e = cumulative simu- 
lation time, real 


NDAY.F 


e 


Integer 


Converts event time 
to the day portion 

e = cumulative event 
time, real 


NORMAL.F 


61, 69, 63 


Real 


Returns a random 
sample from a normal 
distribution 

ei = mean, real 

e2 = standard devia- 
tion, real 

e3 = random number 
stream, integer 


OR.F 


a,b 


Integer 


Logical sum of a and 
b. 
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Function 
Mnemonic 



Arguments 



Function 
Mode 



Description 



OUT.F 



Alpha 



POISSON.F 



61,62 



Integer 



RANDI.F 



61,62,63 Integer 



RANDOM.F 



Real 



REAL.F 



Real 



61 

62 = 



Sets or returns the 
alphanumeric value 
of the eth character 
in the current output 
buffer; e must yield 
an integer value ; 
e>0;bothright- 
and left-handed 
function. 

Returns a random 
sample from a Poisson 
distribution 

mean, real 

random num- 
ber stream, 
integer 
Returns a random 
sample uniformly 
distributed between 
a range of values 

ei = beginning value, 
integer 

ending value, 
integer 

random num- 
ber stream, 
integer 

Returns a pseudo- 
random number 
between zero and 
one 

e = random num- 
ber stream, 
integer 

Converts an integer 
expression to a real 
value. 



62 



63 = 
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Function 




Function 




Mnemonic 


Argument 


Mode 


Description 


RSTEP.F 


V, e 


Real 


Returns a random 
sample from a look- 
up table 

V = variable that 
points to the 
look-up table 

e = random num- 
ber stream, 
integer 


SFIELD.F 


none 


Integer 


Returns the starting 
column of the next 
data field to be read 
by a READ Free Form 
statement. 


SHL.F 


w, n 


Integer 


Shift w left n posi- 
tions, end around. 


SHR.F 


w, n 


Integer 


Shift w right n posi- 
tions, arithmetic. 


SIGN.F 


e 


Integer 


Indicates the sign of 
a real expression. 

life>0 

Oife = 

-life <0 


SIN.F 


e 


Real 


Computes the sine of 
a real expression 
given in radians. 


SQRT.F 


e 


Real 


Computes the square 
root of a real expres- 
sion; e > 0. 


TAN.F 


e 


Real 


Computes the tangent 
of a real expression 
given in radians. 


TRUNC.F 


e 


Integer 


Returns the truncated 
integer value of a real 
expression. 
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Function 
Mnemonic 


Arguments 


Function 
Mode 


Description 


UNIFORM.F 


61,62,63 


Real 


Returns a uniformly 
distributed random 
sample between a 
range of values 

ej = beginning value, 
real 

e2 = ending value, 
real 

63 = random number 
stream, integer 


WEEKDAY.F 


e 


Integer 


Converts event time 
to the weekday por- 
tion 


WEIBULL.F 


61,62,63 


Real 


e = cumulative 

event time, real 
Returns a sample 
value from a Weibull 
distribution 

ei = scale parameter, 
real 

62 = shape parameter, 

real 

63 = random number 

stream, integer 


XOR.F 


a,b 


Integer 


Logical difference of 
a and b. 


YEAR.F 


e 


Integer 


Converts simulation 
time to the year por- 
tion based on values 
given to ORIGIN.R 

e = cumulative 

simulation time, 
real 


ZTIME.F 


none 


Real 


Returns the elapsed 
execution time in 
seconds. 
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SYSTEM DEFINED ROUTINES 


Routine 


Arguments 


Description 


ORIGIN.R 


61,62,63 


Establishes an origin time 
when the calendar format 
is used 

ei = month, integer 

e2 = day, integer 

63 = year, integer 


TIME.R 


none 


Controls simulation timing 
and selects events. 


SNAP.R 


none 


User supplied routine called 
by SIMSCRIPT II.5 when an 
execution error is detected. 


DATE.R 


yi.y2 


Yields the current date and 
current time of day from 
the operating system, 
yi = date, alpha 
y2 = time, alpha 


EOF.R 


e 


Writes an end of file on logical 
unite. 


EXIT.R 


e 


Stops the simulation after 
printing EXIT e and issuing 
a traceback. 


MOVE.F 


VpV2,n 


Move n words 




from one storage 






area to another. 






Vi = Base pointer 






of source 






array 






V2 = Base pointer 






of target array 






n = Number of 






words 



84000450 B 



37 



GENERATED VARIABLES, ATTRIBUTES AND ROUTINES 


Generated 
for 


Generated >, 
TJ1 ^ Name 
Elements 


Definition 


Accumulated 
and tallied 
variables 


Routine Q.variable 


A left-hand monitor- 
ing routine that 
accumulates or 
tallies data 


Entities 
(5 unique 
characters) 


Variables Gentity* 


Global variable hav- 
ing the entity class 
name 




N.entity 


No. of entities of 
the entity class 
(permanent entities 
only) 




K.entity 


Size of entity in 
computer words 
(temporary entities 
only) 




Routines C. entity 


To reserve storage 
for permanent enti- 
ties (i.e., to create 
them) 




D.entity 


Called when destroy- 
ing a temporary 
entity to check for 
set membership error 




A.entity 


Called to list the 
values of entity 



attributes 



Event Notices Variables 
(5 unique 
characters) 



Gevent* 



I.event 



Global variable hav- 
ing the event notice 
name 

Global variable hold- 
ing the subscript for 
this event class in 
the event set 



♦The G prefix entry name is generated only when a word or array number is not 
specified for the indicated name. If this entry is not generated, and associated 
routine and variable names are not present, there is no restriction on the length 
of the name. 
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Generated 
for 


Generated 
Elements 


Name 


Definition 






K.event 


Size of the event 
notice in computer 
words 




Routines 


C. event 


Files events, whose 
priorities are declared 
in BREAK TIES 
statements, in the 
proper event set 






D.event 


Called when destroy- 
ing event notice to 
check for set mem- 
bership error 






A.event 


Called to Ust values 
of event notice 
attributes 


Event notice 
Records 


Attributes 


TIME.A 


Time event is to 
occur 






EUNIT.A 


Equals for an endog- 
enous event; equals 
input unit number 
(# 0) for an exog- 
enous event 






P.EV.S 


Pointer to predecessor 
event in the event set 






S.EV.S 


Pointer to successor 
event in the event set 






M.EV.S 


Set to 1 if the event 
is in the set; set to 
if the event is not in 
the set 


Random 
Variables 


Attributes 
ofRANDOM.E 


PROB.A 

IVALUE.A 
RVALUE.A 


Probability value 

Sample value: 
IVALUE.A contains 
an integer value; 
RVALUE.A con- 
tains a real value 






S. variable 


Pointer to successor 
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Generated 
for 


Generated 
Elements 


Name 


Defmition 


Sets 

(5 unique 
characters) 


Attributes of 
owner entities 


F.set 
L.set 


Pointer to first entity 
inset 

Pointer to last entity 
inset 






N.set 


No. of entities 
currently in the set 




Attributes of 
member enti- 


P.set 


Pointer to predecessor 
entity in set 




ties 


S.set 


Pointer to successor 
inset 






M.set 


Equals 1 if the entity 
is in the set; equals 
if the entity is not in 
the set 




Routines 


T.set 


Files entity first or 
ranked in set 






U.set 


Files entity last in 
set 






V.set 


Files entity before 
specified entity in 
set 






W.set 


Files entity after 
specified entity in 
set 






X.set 


Removes first entity 
from set 






Y.set 


Removes last entity 
from set 






Z.set 


Removes specific 
entity from set 
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SIMII5 COMPILATION CONTROL CARD 



I siMns. 

I SIMII5, Pj, Pj, P3, P4, P5, Pg, P7, 1 
AH the Pj parameters are order independent. 



-Pi 


Source input 


. abs 
. 1 = 


ent 
Ifn 


-P2 


Binary out- 
put 


. absent 
. B = Ifn 
. B = 


-P3 


. Source listing 


. absent 

. L = OUTPUT 

. L = 






. L = 


Ifn 


-P4 


Star, allstai 
and object 
listing 


. absent 
. S = lfn 
. 0=lfn 
. A = 1 f n 
. OS = Ifn 



. AO = lfn 

pr . Compilation . 0PT = fif2. . .f_ 

options . fi = T 

. fi = P 



fi = E 







. fi = 8 






. fi=6 






. fi=N 






. fi=C 






. fi = V 


P6 


Last column 


. LC = n 


P? 


Symbolic 


. absent 




reference 


. R=l 




map 


. R=2 
. R = 3 

.R = 4 
. R = 5 



INPUT assumed 

Source input on file Ifn 

LGO assumed 

Relocatable binary on file Ifn 

No binary output 

Source listing on file OUTPUT 

Suppresses listing output 

except for errors 

Source listing on file Ifn 

No listing 

Star listing on file Ifn 

Object listing on file Ifn 

ADstar listing on file 1 f n 

Star and object listing on 

fde 1 fn 

Allstar and object listing on file 1 fn 

Generate line numbers for 
traceback 

Continue compilation even 
if errors are detected in the 
PREAMBLE 

Do not abort the job if com- 
pilation errors are detected 
Print output at 8 lines/inch 
Print output at 6 lines/inch 
Suppress listing of the PREAMBLE 
Compress source listing 
Use small buffers for compilation 
Last card column to be 
scanned by the compiler 

R=l 

Local map, no line numbers 

Global map, no line numbers 

Local and global map, 

no line numbers 

Global map with line numbers 

Local map, no line numbers 

Global map with line numbers 
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. R=6 


Local map with line numbers 




. R=7 


Local map with line numbers 
Global map, no line numbers 




. R=8 


Local and global map with 
line numbers 


g . Structured 
IF 


. absent 


IF=NEW(i.e.newIF-ELSE- 




ALWAYS construct) 




. IF = OLD 


Unstructured IF 



Examples: 
SIMII5. 

— Source input on INPUT — Abort job if errors in the 

— Source Usting on OUTPUT PREAMBLE or compilation 

— Relocatable binary on LGO errors 

— No star or assembly listings — Last column = 80 

— No line numbers — IF=NEWandR=l 
SIMHS, I = COMPILE, LS = OUTPUT, OPT = PTE8, LC = 72. 

— Source input on file COMPILE 

— Source listing and star listing on file OUTPUT (Note: If all the list- 
ings are directed to the same file, the options can be merged) 

— Continue compilation even if errors are detected in the PREAMBLE 

— Include line numbers for traceback 

— Execute the program even if compilation errors occurred 

— Print the Ustings at 8 lines/inch 

— Last column = 72. 
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SIMII5 EXECUTION CONTROL CARD 



LGO. 

,LGO,fi.f2,...f„,Pj,P2,P3. 



h'h' 



■ ■L 



External file name substitution 
SIMUn=lfn 
n = internal logical unit number < n < 9 

— even numbered units are carriage 
control files 

— odd numbered units are non-slew 
BCD files 

— any unit number can be used for 
binary files, (except 5 and 6) 

Ifn = external file name 
FORTRAN file name definition 
TAPEn=lfn 

FTN routines must be compiled with 

SYSEDIT = FILES 

All files used by FORTRAN must be 

declared. 

FORTRAN cannot share SIMSCRUT 

files. 



Pi 



■ Print limit 



PL = n n is the maximum number of 
decimal hnes to print on the 
OUTPUT file (default: 10000) 

P2 — Dynamic storage DS = n n is the octal or decimal number 
of words reserved initially for 
dynamic storage. Assumed octal. 
(Ex: 4000 or 4000B, lOOOOD) 

P3 — User parameters PARM = gj, §2, . . • ■ gn! 

gj represents either a single value or 
a group of values separated by an =, 
a+or a— sign. 



Examples: 

LGO. - SIMU5 = INPUT 

- SIMU6 = OUTPUT 

- No FORTRAN files 

- Print Umit on output = 1 0000 

LGO, SIMU5 = INPT, SIMU8 = REPORT, PL = 15000, DS = 20000B. 

- Input on file INPT 

- SIMU6 = OUTPUT 

- Additional file SIMU8 = REPORT 

- Print hmit on OUTPUT = 1 5000 Unas 

- Initial dynamic storage = 20000B 
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CHARACTER SET 



? 9 - = 2 <? 9 ; 



1 S 



8 I 



at^V A^-j 






jKSsaaassRs 



• 11 

1 ° !« 



s ti I 






J c a as -5 
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